Manage orders - Gets a list of product promotions.
取得合作夥伴的可用促銷。
GET https://api.partnercenter.microsoft.com/v{version}/productpromotions
GET https://api.partnercenter.microsoft.com/v{version}/productpromotions?country={country}&segment={segment}
URI 參數
| 名稱 | 位於 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
version
|
path | True |
string |
|
|
country
|
query |
string |
國家/ 地區。 |
|
|
segment
|
query |
string |
區段。 |
要求標頭
| 名稱 | 必要 | 類型 | Description |
|---|---|---|---|
| Authorization | True |
string |
授權持有人令牌 |
| ms-correlationid |
string |
用於在內部追蹤要求。 如果未提供 ms-correlationid,伺服器會為每個要求產生新的要求 |
|
| MS-CV |
string |
用於在內部追蹤要求。 如果未提供 MS-CV,伺服器將會為每個要求產生新的要求 |
|
| ms-requestid |
string |
用於要求等冪性。 如果未提供 ms-requestid,伺服器將會為每個要求產生新的要求 |
回應
| 名稱 | 類型 | Description |
|---|---|---|
| 200 OK |
要求成功。 回應本文將包含合作夥伴的促銷清單。 Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 400 Bad Request |
輸入遺失或無效。 回應本文會提供錯誤詳細數據。 Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 401 Unauthorized |
要求未通過驗證。 客戶端必須先向合作夥伴 API 服務進行驗證。 Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 403 Forbidden |
要求已通過驗證,但因為呼叫端沒有叫用要求的許可權而遭到拒絕。 Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 404 Not Found |
找不到資源,或無法使用指定的輸入參數。 Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 500 Internal Server Error |
合作夥伴 API 服務或其其中一個相依性無法滿足要求。 Media Types: "application/json", "text/json", "application/xml", "text/xml" |
定義
Contracts.V1.Models.ProductPromotion
| 名稱 | 類型 | Description |
|---|---|---|
| description |
string |
|
| endDate |
string (date-time) |
|
| id |
string |
|
| name |
string |
|
| properties | ||
| requiredProducts | ||
| startDate |
string (date-time) |
Contracts.V1.Models.ProductPromotionPricingPolicy
| 名稱 | 類型 | Description |
|---|---|---|
| policyType |
string |
|
| value |
string |
Contracts.V1.Models.ProductPromotionProperties
| 名稱 | 類型 | Description |
|---|---|---|
| isAutoApplicable |
boolean |
Contracts.V1.Models.ProductPromotionRequiredProduct
| 名稱 | 類型 | Description |
|---|---|---|
| pricingPolicies | ||
| productId |
string |
|
| skuId |
string |
|
| term |
Contracts.V1.Models.ProductPromotionTerm
| 名稱 | 類型 | Description |
|---|---|---|
| billingCycle |
string |
|
| duration |
string |
Link
| 名稱 | 類型 | Description |
|---|---|---|
| body |
string |
|
| headers |
System. |
|
| method |
string |
|
| uri |
string |
ResourceAttributes
| 名稱 | 類型 | Description |
|---|---|---|
| etag |
string |
|
| objectType |
string |
ResourceCollection[Contracts.V1.Models.ProductPromotion]
| 名稱 | 類型 | Description |
|---|---|---|
| attributes | ||
| items | ||
| links | ||
| totalCount |
integer (int32) |
ResourceLinks
| 名稱 | 類型 | Description |
|---|---|---|
| next | ||
| previous | ||
| self |
System.Collections.Generic.KeyValuePair[System.String,System.String]
| 名稱 | 類型 | Description |
|---|---|---|
| key |
string |
|
| value |
string |